home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / renegade / rgm0405.zip / RGMAINT.DOC < prev    next >
Text File  |  1996-04-05  |  13KB  |  256 lines
  1.  
  2.  
  3.                      R E N E G A D E   M A I N T E N A N C E
  4.                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  5.  
  6.                         Renegade Daily Maintenance Program
  7.  
  8.                                 Operations Manual
  9.  
  10.                                   Version 1.00
  11.  
  12.                          Copyright (C) 1994 by Cott Lang
  13.                                All Rights Reserved.
  14.  
  15.  
  16.  
  17.                                   INTRODUCTION
  18.          _________________________________________________________________
  19.  
  20.              This documentation assumes that you have a working knowledge of
  21.         the Renegade Bulletin Board System. It is beyond the scope  of  this
  22.         documentation  to  explain the  concepts behind some of the features
  23.         included in Renegade.
  24.  
  25.              RGMAINT is a maintenance program for Renegade that can be run
  26.         automatically or  manually as  frequently or  infrequently as  you
  27.         like.  Its features include:
  28.  
  29.           o  Automatically wait until all users have logged off your system
  30.              until beginning processing, and time slicing until then. RGMAINT
  31.              will actually attempt to force the users off the system.
  32.  
  33.           o  Purging users by date.  RGMAINT will purge users that have been
  34.              inactive for a certain number of days.  RGMAINT allows an ACS
  35.              to be specified to exempt certain users from this purging. Users
  36.              flagged as "no deletion" will not be purged regardless.
  37.  
  38.           o  Purging users by ACS.  RGMAINT will allow you to specify an ACS
  39.              to delete users by.  If a user meets that ACS, they are deleted.
  40.  
  41.           o  Removing users.  Unlike most Renegade user purgers, RGMAINT
  42.              physically removes the user's record from the user file, making
  43.              a significant savings in disk space and access time.  RGMAINT
  44.              will check available drive space before attempting to process
  45.              the user file.
  46.  
  47.           o  Removing votes.  RGMAINT will remove the votes of the newly
  48.              deleted users from the voting results.  RGMAINT will not remove
  49.              the votes of users that were previously deleted and are only
  50.              being removed by RGMAINT.
  51.  
  52.           o  Packing and Updating all message bases.  RGMAINT will not only
  53.              pack all of your message bases, but it will delete all email
  54.              to and from deleted/removed users, and automatically correct
  55.              to/from user numbers according to the users' NEW user numbers
  56.              caused by the actual packing of the user file.  RGMAINT will
  57.              check available drive space before attempting to pack any
  58.              message base.
  59.  
  60.           o  Packing, Updating, and sorting of all file bases.  RGMAINT will
  61.              not only sort all of your file bases, but it will also pack your
  62.              EXTENDED.DAT file, and renumber all file "uploader" numbers to
  63.              reflect the user's new user number. RGMAINT is smart enough to
  64.              avoid packing file areas that it hasn't the memory to process.
  65.  
  66.           o  Update and Pack SHORTMSG.DAT to reflect the new user numbers and
  67.              make the file smaller for faster logon times.
  68.  
  69.           o  Updating and packing the user message pointers and scan
  70.              selection (.SCN) files.
  71.  
  72.           o  Recheck file sizes and on/offline status.
  73.  
  74.  
  75.              RGMAINT does  not have its own configuration.  RGMAINT relies
  76.         completely  on your  Renegade Bulletin  Board System's configuration
  77.         for all necessary information.
  78.  
  79.  
  80.  
  81.                                   INSTALLATION
  82.          _________________________________________________________________
  83.  
  84.  
  85.              If you have not already, decompress the  RGMAINT   distribution
  86.         archive onto your  hard drive.  RGMAINT.EXE  is the  only  required
  87.         program in the archive.It can be placed anywhere on your hard drive,
  88.         and run from anywhere  on your system.  It  is, however, recommended
  89.         that you place it in your main Renegade directory.
  90.  
  91.              When RGMAINT runs, it needs to be able to  locate your system's
  92.         RENEGADE.DAT file. RGMAINT will first search  the current directory,
  93.         then it will search your path.   If  you  are  not  running  RGMAINT
  94.         from your main Renegade directory, then make sure your main Renegade
  95.         directory is part of your path.  It is strongly recommended that you
  96.         run RGMAINT  from your  main directory  and that you  NOT  have your
  97.         Renegade main directory in your path statement for security reasons.
  98.  
  99.  
  100.                                    OPERATION
  101.          _________________________________________________________________
  102.  
  103.              RGMAINT has several command line options, all of which can work
  104.          independently of the others.
  105.  
  106.  
  107.               Syntax:
  108.  
  109.                          RGMAINT -[FLAG][DATA]
  110.  
  111.           Where [FLAG] is one of the following:
  112.  
  113.                 -?    Displays a short help screen.
  114.  
  115.                 -P#   Purges users who have not called in # days.
  116.  
  117.                       example:
  118.  
  119.                       RGMAINT -P60
  120.  
  121.                       purges users not having called for 60 days.
  122.  
  123.                 -E$   Exempts users of acs $ from purging by above
  124.                       command line.  If the -P option is not used,
  125.                       this command is not necessary.
  126.  
  127.                       example:
  128.  
  129.                       RGMAINT -P60 -Es250
  130.  
  131.                       Will delete anybody below security level 250
  132.                       who has not logged on in 60 days.
  133.  
  134.  
  135.                 -K$   Will kill any user meeting the $ acs.  This can
  136.                       be used with or without any combination of the
  137.                       above command lines.
  138.  
  139.                       example:
  140.  
  141.                       RGMAINT -K!s25
  142.  
  143.                       Will kill anyone with security below level 25.
  144.  
  145.  
  146.                 -R    Informs RGMAINT to recheck all files. It will
  147.                       check to see if the file exists, and modify it's
  148.                       request flag accordingly. It will also update
  149.                       the file's  size if  that  is  incorrect.  The
  150.                       recheck option will significantly slow down file
  151.                       sorting.
  152.  
  153.                 -W#   Wait # minutes for users to logoff.  RGMAINT will
  154.                       attempt to force a disconnect of every active
  155.                       node, wait thirty seconds while time slicing, then
  156.                       recheck all nodes.  If in # minutes of doing this,
  157.                       all users are not logged off, RGMAINT will abort
  158.                       processing.  Renegade will recycle that node, meaning,
  159.                       it will exit to dos. You must have your batch files
  160.                       setup to handle this situation before using this
  161.                       commandline in an automated fashion.
  162.  
  163.  
  164.                                   USAGE NOTES
  165.          _________________________________________________________________
  166.  
  167.             RGMAINT does NOT destroy it's temporary backups of the user file
  168.          or any file  that it  encountered an  error in processing.  You can
  169.          delete USERS.BAK at your leisure.
  170.  
  171.             RGMAINT  requires  approximately 128k  to run.  However, if  you
  172.          have very large file areas (dir files), it could take more. RGMAINT
  173.          is smart  enough to not  attempt processing .DIR files that are too
  174.          large for available  memory. They will simply  not be sorted; their
  175.          extended descriptions  will still be packed.  Therefore, you should
  176.          not be overly concerned with any "insufficient memory" warnings.
  177.  
  178.  
  179.                                  REGISTRATION
  180.          _________________________________________________________________
  181.  
  182.             This program  is now  free, just  like Renegade.  HOWEVER, it is
  183.          requested  that  if  you already  haven't  registered for  Renegade
  184.          support  on  the  author's  board, you  do  so  with  the  enclosed
  185.          REGISTER.DOC. The cost is only $25. Considering Renegade and all of
  186.          it's  related utilities  are FREE, $25 is nothing. If you think $25
  187.          is too much, why are you the ones  that compare  Renegade's support
  188.          to that of PCBoard, Wildcat, or some other $300 BBS package?
  189.  
  190.             In addition, your $25 will  buy you a  permanent account  on The
  191.          Digital Play Ground, the  author's  four line  system with  all the
  192.          latest Renegade utilities available for download.
  193.  
  194.             If you do NOT register, then you have no right to complain about
  195.          anything.  To paraphrase Martin Pollard:
  196.  
  197.                 Why am I doing this?  It's quite simple: I'm tired of giving
  198.          away something  for free, and getting nothing  but grief in return.
  199.          The majority of the Renegade sysops have  no  respect for  software
  200.          authors, conference  rules, or even common human  decency. They not
  201.          only expect  everything  handed to  them for free, they  DEMAND it,
  202.          and expect me to kiss their asses while doing it.
  203.  
  204.             So, in exchange for my sacrificing  a significant portion  of my
  205.          life and mental health in  providing you with Renegade, I am asking
  206.          that you help me pay for  my BBS.  If you  don't  feel Renegade  is
  207.          worth $25, then  I  can't see why  you're running  it.  I certainly
  208.          can't see any reason why I should assist you in running Renegade.
  209.  
  210.  
  211.             To  register   for  support,  you  need  simply   to  fill   out
  212.          REGISTER.DOC included in the RGMAINT package, print it, and mail it
  213.          to the author at the address indicated.
  214.  
  215.  
  216.                            SHAREWARE LICENSE AGREEMENT
  217.          _________________________________________________________________
  218.  
  219.  
  220.        This  software  and documentation is protected by both United States 
  221.        copyright  law and international treaty provisions. This "Shareware" 
  222.        version  of RGMAINT is  NEITHER PUBLIC  DOMAIN  NOR  FREE  SOFTWARE.
  223.        Users are granted  a  limited  license to make and use an evaluation
  224.        copy for  trial  use on  a private, non-commercial, non-governmental
  225.        basis, for  the  express  purpose  of  determining  whether  RGMAINT
  226.        suitable for their needs. At the end of this trial period you should
  227.        either register RGMAINT or discontinue use.
  228.        
  229.        You  may make copies of the software and documentation only for your 
  230.        own  use or for the use of others in conducting their own trial use, 
  231.        however  all materials relating to this license statement, software, 
  232.        documentation,    order   information,   copyright   and   trademark  
  233.        statements  must remain intact as supplied in the original shareware 
  234.        package.  You  may  not  distribute,  rent, sublicense, integrate or 
  235.        lease  the software or the documentation. You may not alter, modify, 
  236.        or  adapt  the  software or documentation, including but not limited 
  237.        to   translating,   decompiling,  reverse  assembling,  or  creating 
  238.        derivative  works.  You  may  not  use  the  software  in a network, 
  239.        timesharing, multiple  CPU, or  multi-user  environment.  Registered
  240.        copies are  licensed  only  for use  BY  the  registrant on a single
  241.        computer.  You  may not   use registered   copies on   more than one
  242.        computer at the same time.  Registrations are non-transferrable.
  243.  
  244.        The author  disclaims all   warranties, either   express or implied,
  245.        including but  not limited to implied warranties of  merchantability
  246.        and fitness  for a particular purpose, with  respect to the software
  247.        and any accompanying written materials. In no event shall the author
  248.        be liable for any damages whatsoever (including, without limitation,
  249.        damages for loss of business profits, business interruption, loss of
  250.        business information, or  other pecuniary  loss) arising  out of the
  251.        use of  this  product,  even if  the author  has been advised of the
  252.        possibility of  such damges.  Because some  states do  not allow the
  253.        exclusion or limitation of liability for consequential or incidental
  254.        damges, the above limitations may not apply to you.
  255.  
  256.